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This publication describes the preparation 
and use of the Basic Assembler and Basic 
Utility Programs. The Basic Assembler con- 
verts programs written in the assembler 
language into machine language object code. 
The Basic Utility Programs are concerned 
with loading programs into storage, print- 
ing out the contents of storage, and using 
input/output devices. 








PREFACE 


This publication contains information on 
the preparation and use of the IBM 
System/360 Basic Programming Support Basic 
Assembler and Basic Utility Programs. The 
Basic Assembler is discussed first, fol- 
lowed by each of the Basic Utility Pro- 
grams. 


MAJOR REVISION (June 1965) 


: This revision, which supersedes the pre- 
vious edition, represents Version 2 of the 
subject programs. The changes are marked 
by a vertical bar to the left of the 
revised text; revised illustrations are 
denoted by the symbol e to the left of the 
caption. 


This publication was prepared for production using an IBM computer to update 
the text and to control the page and line format. Page impressions for 
photo-offset printing were obtained from an IBM 1403 Printer using a special 
print chain. 


Copies of this and other IBM publications can be obtained through IBM Branch 
Offices. 
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The IBM System/360 Basic Programming 
Support Operating Guide publication pro- 
vides operating information and techniques 
for the System/360 Basic Assembler and 
Basic Utility Programs. The Basic Assembly 
Program accepts source programs written in 
System/360 Basic Assembler Language and 
produces object programs in System/360 
machine language. The Basic Utility Pro- 
grams enable the user to print out the 
contents of registers and/or storage, load 
assembled programs, and program the use of 
input/output devices. 


This publication is concerned only with 
operating considerations, not with the 
internal logic of the programs. Specifi- 
cally, the following topics are discussed: 


INTRODUCTION 


Preparing and running an assembly job. 


Using the 
ers. 


IBM-supplied program load- 


Preparing and generating 
program loaders. 


self-loading 


Using the single- or two-phase dump 
program to print out the contents of 
storage. 


Using the self-loading dump program. 


Program waits and operator messages. 
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THE BASIC ASSEMBLER 


The Basic Assembler is, essentially, a 
language translator. It translates source 
programs written in the Basic Assembler 
language into executable machine-language 
object programs. The assembler is divided 
into two parts, Phase 1 and Phase 2. 


consists of source 
program statements punched into cards or 
written on magnetic tape. Phase 1 partial- 
ly translates the source program statements 
into machine-language object code. The 
partially translated statements are passed 
to Phase 2 (see Figure 1) where the trans- 
lation process is completed. The output 
produced by Phase 1 (that is, the partially 
translated source statements) must be 
passed to Phase 2 via punched cards or 
Magnetic tape. 


Input to Phase 1 


Note: Certain 
that do not fall into the normal BCD 
configuration, when entered into System/360 
by means of another computer, may lose bits 
during the card-to-tape phase. 


Program Listings 


' the assembler may be punched in 


character constants (C* ‘) | 


Assembled Object Program Output 


Assembled object programs produced by 

cards or 
written on tape. The specification of the 
object program storage medium is described 
in detail in the section "Phase 1 Configu- 


ration Card." 


Machine Configuration 


The IBM System/360 Basic Programming 
Support Basic Assembler program requires 
the following minimum machine configu- 
ration: 


e An IBM System/360 with 8,192 
storage 


bytes of 


e An IBM 2540 or 1442-2 Card Reader-Punch 
e The Standard Instruction Set 


If additional input/output devices are 


attached to the system, the assembler's 
operational capabilities are increased. 
The various input/output devices and their 


uses are listed below. 


IBM 2400-Series Magnetic Tape Unit: 


The assembler provides a program or From one to five magnetic tape units can 
error listing for each assembly if a print- be used for the storage of any of the 
er or printer-keyboard is attached to the following: 
system, and the assembler has been 
instructed to provide listings or error 1. Source program 
listings. This is described in detail in 2. Basic Assembler object decks 
the section “Phase 1 Configuration Card." 3. Intermediate text 
Ga a a ey ee a ee ey a Ta ae ged eT en ee at ape eT a ee 1 
| | 
| | 
| | 
| -----—---~—-- f--------- Assembled | 
| Source | Phase 1 | Intermediate | Phase 2 | Object | 
| program ->| of the |-> text ->| of the |-> program | 
| from cards | Basic | on cards | Basic on cards | 
i or tape | Assembler | or tape | Assembler | or tape, | 
| t-—_——--~—-~—— 4 t----——-—~~—~— 4 listing on | 
| printer,printer- | 
| keyboard, | 
| | 
| | 
Ne a a a i i al a IR el ga Se 4 


Figure 1. 


Basic Programming Support Basic Assembler 


4. Program listing 
5. Object program 


One IBM 1403 or 1443-2 Printer: Used by 
the assembler to provide program listings, 
complete with operator and error messages, 
for each assembly. 


One IBM 1052 Printer-Keyboard: Used by the 
assembler to provide program listings, com- 


plete with operator and error messages, for 
each assembly. 


One IBM 1403 or 1443-2 Printer and One IBM 
1052. Printer-Keyboard: The assembler uses 
the IBM 1403 or 1443-2 Printer to print 
program listings. The IBM 1052 Printer~ 
Keyboard is used for operator and error 
messages. 





ASSEMBLER INITIALIZATION 


Since all installations do not have the 
same machine configuration, the Basic 
Assembler program must be tailored for 
operation at each installation. This 
tailoring consists of defining to the 
assembler: 


1. The main-storage size of the system. 


2. The input/output devices attached to 
the system and their addresses. 


3. What use is to be made of cards and 
magnetic tape. 


In addition to the initialization asso- 
ciated with the machine configuration, 
other initialization May instruct the 
assembler to print or suppress program 
listings or to print only error listings. 


The Basic Assembler is initialized 
through the use of configuration cards. 
There are two configuration cards, one for 
each phase of the assembly program. The 
cards are called the Phase 1 and Phase 2 
Configuration Cards. 


Phase 1 Configuration Card 


The Phase 1 Configuration Card isa 
Replace card which describes to Phase 1 of 
the assembler the machine configuration 
upon which it is to operate. The card is 
inserted in the Phase 1 deck just before 
the END card. The Phase 1 Configuration 
Card has the following format: 


—_> om 


Nb 
—_ 


NO 
No 
' 
No 
mn 


ht NO 
oe 
eu) 
Oo 


io 
= 


WW 
No 
t 
Ww 
in 


|Contains a 12-2-9 punch fol-| 
flowed by the characters REP. | 
|This identifies the card as a| 
{configuration card. | 
| 
| 
| 


| 

| Blank. 
| 

{Contains 00008A. This is the| 
Jhexadecimal starting address, | 
Jin storage, where the data in| 
|coluins 17-55 is to be placed. | 


| Blank. 


{Contains 61. This is a con- 
jstant. 


{Contains a 0, if the _ source| 
Jinput device is a card reader, | 
{followed by the three-digit| 
J|hexadecimal address of the| 
jreader. If the source input| 
|device is a tape unit, the| 
[field contains a 1, followed| 
{by the three-digit hexadecimal | 
jaddress of the source device. | 


| 
| Comma. | 
| 


|if the intermediate text data| 
jis to be stored on cards, this| 
jfield contains a 0, followed| 
jby the three-digit hexadecimal | 
jJaddress of the card punch. If| 
|the intermediate text is to be| 
jstored on tape, the field con-| 
jtains a 1, followed by the| 
{three-digit hexadecimal ad- | 
jdress of the tape unit. 


| Comma. 


|I£f the assembler is to be| 
{copied on tape, this field| 
jcontains a 1, followed by the| 
{three-digit hexadecimal ad-| 
{dress of the tape unit which| 
Jwill be used. If the assem-| 
{bler is not to be copied, the| 
|field contains O's. 


| Comma. 


j|Contains a 0, followed by the| 
{three-digit hexadecimal ad-| 
|dress of the system message| 
j|device -- a printer or al 
{printer-keyboard -- or- O's, if| 
[neither of these devices is| 
jattached to the system. | 


(continued) 
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(continued) 


acm beriesians scares a At Bae ME ia 1 
| | Description | 


}-----}----}---------~-------------------- { 
|37-40] 12 {If the program listing is to] 
jbe printed on the printer or] 
|printer-keyboard, this field| 
j|contains a 0, followed by the] 
| three-digit hexadecimal ad-| 
{dress of one of these. If the] 
jlisting is to be written on| 
jtape, the field contains a 1,| 
|followed by the address of the] 
|tape unit. If none of these| 
jdevices is used, the field| 
|contains 0's. 


13 |Comma. 


| 
14 {If the final object program is| 
|to be punched on cards, this| 
}field contains a 0, followed| 
|by the three-digit hexadecimal | 
jaddress of the card punch. If| 
|the object program is to be| 
Jwritten on tape, the field| 
|contains a 1, followed by the| 
jaddress of the tape unit. | 
| | 
15 | Comma. | 
| 
16 |Contains a four-digit hexa-| 
|decimal number. The first two| 
|digits indicate the mode set| 
{code (see Figure 2) for the| 
|source input tape. The second| 
|two digits indicate the mode| 
Jset code for the object pro-| 
|gram output. 


| 
| | 
17 |Comma. | 

| 


| 

18 |The first two digits of this| 
|field indicate the mode set] 
{code (Figure 2) for the device| 
jon which a listing is to be| 
|written. The second two | 
[digits are composed of the] 
|following bit formations: | 
1. Hexadecimal equivalent of | 
a four-bit binary number| 
generated in the follow-| 

ing way: 
e The first two bits are| 
O's. | 
e The next two bits | 
depend on the machine's| 
main storage Size: | 
00 for 8K | 
01 for 16K | 
10 for 32K | 
11 for 64K | 
2. Hexadecimal equivalent of | 
a four-bit binary number | 
generated in the follow-| 
ing way: | 
a a a 


(continued) 


eFigure 2. 


(continued) 


+ 
| 

+ 

| e The first bit isa 0. | 
| e The second bit is a 0,| 
| if a 2540 Card Reader-| 
| Punch is attached to] 
| the system, or al, if| 
| the 1442-2 Card Reader- | 
| Punch is attached to| 
| the system. | 
| e The third and fourth| 
| bits are O's. | 
L 


-—— 


ee ee ee ee lta eee eee ele ce cette re ee ee Se a ec a A A ee SO 


4 
{Column 56 must’ be blank; columns 57-80] 
{may include anything which the programmer | 
jwishes, 


age a a ge eg ee eee et ee ee 1 
|The code 03 must be used for all 9-track| 


jtapes and unit record devices. It is] 
Jused for all 7-track tapes which will be| 
jused only on System/360. | 
| | 
|The following mode set codes are used for| 
|7-track tapes which will be used on| 
|System/360 and some other machine: 


| | 
| Code Density Parity | 
| 2B 200 BPI Even | 
| 3B 200 BPI odd | 
| 6B 556 BPI Even | 
| 7B 556 BPI odd | 
| AB 800 BPI Even | 
| BB 800 BPI odd | 
t 


Mode Set Codes 


Phase 2 Configuration Card 


The Phase 2 Configuration Card is 
identical to the Phase 1 Configuration 


Card, except that columns 54 and 55 are 
punched in the following manner: 
Column 54. 
bit 1 isa 0. 
bit 2 is a1, if a program: listing is 
to be generated for the assembly. 
It is a 0, if only an error 
listing is desired. 
bit 3 isa 0. 
bit 4 isa 0, if the printer is used to 


produce program listings. It is 
a 1, if the listings are produced 
on a printer-keyboard. 


Column 55 isa 0. 


The results of mispunching configuration 
cards are unpredictable. 


RUNNING AN ASSEMBLY JOB 


A. ASSEMBLING ON A CARD SYSTEM USING THE 9. Select the card reader with the load- 

2540 unit switches on the system control 
panel and press load key. 

Assembler: cards 10. +A program wait with the location 

Source deck: cards counter containing 1EI occurs at the 

Intermediate text: cards completion of Phase 1. If the system 

Object program: cards has provisions for typing messages, a 

Listing: printer or printer-keyboard message “1EI" is typed on the printer 

or printer-keyboard. The contents of 

1. Make the printer and printer-keyboard the stackers at this point are shown 
ready for use. in Figure 3. 

2. Clear the card reader of cards. 

11. Make printer or printer-keyboard ready 

3. Insert the proper configuration cards for use if necessary. 
immediately before the END card in 
both decks of the assembler. Detailed 12. Clear the card reader of cards. 
information concerning these cards is 
presented in the section "Assembler 13. Place the Phase 2 deck of the assem- 
Initialization." bler in the card read hopper. 

4, Place the Phase 1 deck of the assem- 14. Place intermediate text deck on the 
bler in the reader hopper; then place assembler deck. 
the source program deck in the hopper. 

15. Place blank cards in the punch hopper 

5. Place blank cards in the punch hopper. at the ratio of one blank card for 
The number of blank cards must be every ten source program cards. 
equal to or greater than the number of 
cards contained in the source program 16. Press end-of-file key on card reader- 
deck. punch. 

6. Place additional blank cards for the 17. Select the card reader with the load- 
symbol table in the punch hopper at unit switches on the system control 
the ratio of approximately one biank panel and press the load key. 
card for every twenty source program 
cards. 18. A "2EI" message or a program wait with 

the location counter containing 2EI 

7. %Initialize card reader-punch for use. Signals the end of the second phase of 

assembling. The contents of the 

8. Press end-of-file key on the card stackers at the completion of the 
reader-punch. assembly job are shown in Figure 4. 

aa ee ye se a oe a ate alae RT ae Tee ee tT ee aa ge ee ee 1 
| 2540 | 
| | | | | | | | | | | | 
| | | | | | | | | | | | 
| | | | | | | | | | | | 
| re | | | | | | | | | 
| | Intermed. | eae re Sas | | ‘a 4 =e | 
| | Text | | Symbol | | | | Source | | Phase 1 | | 
| | | | Table | | | | Deck j | Deck | | 
| tt theese J ort J tec L2ecos ete J oases J | 
| 0 4 8/2 1 0 | 
| ------------------------------------------------~--~----~-~--~------~-~---------------- 4 


| The intermediate text deck consists of data produced by Phase 1 for use aS input to | 
| Phase 2. The symbol table deck is produced for use in a Special application described| 
| in the section "Special Procedures." | 
L 


@Figure 3. Stacker Contents at End of Phase 1 
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eFigure 4. 


Object | 
Deck | 
ee eee ee 4 becuseeces J  eaeemeren 
0 4 


B. ASSEMBLING ON A CARD SYSTEM USING THE 


1442 


10. 


10 


Assembler: cards 

Source deck: cards 

Intermediate text: cards 

Object program: cards 

Listing: printer or printer-keyboard 


Make the printer and printer-keyboard 
ready for use. 


Clear the card reader of cards. 


Insert the proper configuration cards 
immediately before the END card in 
both decks of the assembler. Detailed 
information concerning configuration 
cards is presented in the section 
"Assembler Initialization." 


Place the Phase 1 deck of the assem- 
bler in the reader hopper. Then place 
the source program deck in the hopper. 


Place blank cards for the symbol table 
in the hopper at the ratio of approxi- 
mately one blank card for every twenty 
source program cards. 


Initialize card reader-punch for use. 
(Do not press end-of-file key.) 


Select the card reader with the load- 
unit switches on the system control 
panel and press the load key. 


A program wait with the location 
counter containing 1EI occurs at _ the 
completion of Phase 1. If the system 
has provisions for typing messages, a 
message "“1EI" is typed on the printer 
or printer-keyboard. The contents of 
the stackers at this point are shown 
in Figure 5. 


Make the printer and printer-keyboard 
ready for use if necessary. 


Clear the card reader of cards. 


ee ee te Ae Oe A eS SEN SN NS Se YS RD RE ON SS ES SN AO PN NE SD AON SY SONNY DS SR YS NS SS SS SRN NT Me GS nn a ct ee ate 


Stacker Contents at End of Assembly 


1 

| 

| | | | | | 

| | [| = --------- | 

| | | | Intermed. | | 

| | | | Text | | 

| |-----—--- {00 fee | 

| | Source | | Phase 2 | | 

| | Deck | | Deck | | 

Sess J Se a ae a cee Ue eiakaecoceed | 

8/2 1 0 | 

J 

a aa a Aaa ar 1 

| 1442 j 

| | | | | | 

| p--~————- 1 | | | 

| | Symbol | | | | 

| | Table | | | | 

| }-—-----{  — |-------- | 

| {| Source | | Phasel | | 

| | Deck | | Deck | | 

| be J Poca sees J | 

| 2 1 | 

| ----------------------------------------- { 
| 


The intermediate text deck consists of | 
{data produced by Phase 1 for use as input| 
jto Phase 2. The symbol table deck is| 
{produced for use in a special application| 
|described in the section "Special Proce-| 


|dures." Note that the intermediate text| 

jis contained in columns 1-24 of the| 

Jsource deck on the 1442. | 

Bi eee a ts Se eS 4 

Figure 5. Stacker Contents at End of 
Phase 1 


11. Place Phase 2 deck of the assembler in 
the card read hopper. 

12. Place the source program deck in the 
card hopper. 

13. Place blank cards in the hopper behind 
the source program deck. 

14. Select the card reader with the load- 
unit switches on the system control 
panel and press the load key. 

15. A program wait with the location 


counter containing 2HA or a message 
"2HA" indicates that blank cards must 
be placed in the 1442 card hopper. 
Remove any cards in the hopper, insert 
blanks, and replace the cards just 
removed. The number of blank cards is 
governed by the machine's storage 
Size: 15 blanks for an 8K machine, 80 
blanks for a 16K machine, 200 blanks 
for a 32K niachine, and 800 blanks for 
a 64K machine. After inserting the 
blanks, press the interrupt key. 


16. 


17. 


Figure 6. 


A “2EI" message or a program wait with 
the location counter containing 2EI 
signals the end of the second phase of 
assembling. 


The contents of the stackers at the 
completion of assembling are shown in 
Figure 6. 


se a aE Sak ee ttle . 

442 | 

| | | | | 

| | | | | 

| | t--------1 | 

| | | Source | | 

| | | Deck | | 

--------4 }-------- | 

| Object | | Phase 2] | 

{| Deck | | Deck | | 

Pos beter at | 

2 1 | 

a es ee te haa 29 eee eats ee het ee ee 4 

Stacker Contents at End of 
Assembly 


COPYING THE ASSEMBLER ON TAPE 


C. 


Punch the correct configuration cards 
(described in detail in “Assembler 
Initialization") and place them before 
the END cards in Phases 1 and 2. 


Ready the card reader. 


Place Phases 1 and 2 of the assembler 
in the read hopper. 


Load tape on tape unit whose address 
was specified in field 8 of configu- 
ration cards. 


Ready tape unit. 
Press end-of-file on card reader. 


Select the card reader with the load- 
unit switches on the system control 
panel and press load key. 


When the "1EI" message appears in the 
location counter, press load keya 
second time to write Phase 2 on tape. 


When the "2EI" message is printed or 
appears in the location counter, the 
assembler has been written entirely on 
the selected tape. Rewind before 
using. (Note that the assembler may 
be written on one tape unit and run on 
a different tape unit, provided they 
both have the same number of tracks.) 


D. 


ASSEMBLING WITH CARD AND TAPE 
CONFIGURATION 


Assembler: cards or tape 

Source deck: cards or tape 
Intermediate text: cards or tape 
Object program: cards or tape 
Listing: printer, printer-keyboard, 
or tape 


Ready assembler input device. 
Ready source program input device. 
Ready intermediate text device. 
Ready object program device. 

Ready listing device. 


Select assembler input device with 
load-unit Switches on the system 
control panel and press load key. 


If intermediate text medium is punched 
cards, see steps A 10-18 or B 8-16 in 
the preceding sets of instructions. 


If intermediate text is on tape and 
the assembler is on cards, a "1EI" 
message or a program wait with the 
location counter containing 1EI sig- 
nals the end of Phase 1. Load Phase 2 
of the assembler. If the assembler is 
on tape, the message will not appear 
and control will automatically pass to 
Phase 2. Note that when the inter- 
mediate text is on tape, Phase 2 must 
always follow immediately after Phase 
1, Since no symbol table is punched. 


A "2EI" message or a program wait with 
the location counter containing 2EI 
Signals the end of the second phase of 
assembling. 


SPECIAL PROCEDURES 


There are three special procedures 
available for use with card systems. They 
are: 


1. 


3. 


A procedure for saving time when reas- 
sembling a previously assembled pro- 
gram on a 1442 card system. 


A procedure for running an assembly 
job on a card system when Phase 2 
is not executed immediately after 
Phase 1. 


A procedure for saving time during 
Phase 2 when using a 1442 card system 
that punches the assembled object pro- 
grams into cards. 
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1442 Card System Reassembly Procedure 


A special reassembly procedure is pro- 
vided for card systems using the IBM 1442-2 
Card Reader-Punch. This procedure enables 
a previously assembled program to be reas- 
sembled in less time than that required for 
a new assembly. 


To use this procedure, one must have the 
symbol table deck produced by Phase 1 of 
the previous assembly (See Figure 3). 
Input to Phase 1 during a reassembly con- 
sists of the Phase 1 assembler deck fol- 
lowed, in order, by the previously punched 
symbol table, the source program, and blank 
cards (into which the new symbol table wili 
be punched) . The number of blank cards 
should be approximately equal to the number 
of cards in the previously punched symbol 
table. Note that the only difference 
between the Phase 1 input required for a 
new assembly and the Phase 1 input required 
for a reassembly is the inclusion of the 
symbol table deck in the latter case. 
Other than preparing the Phase 1 input, the 
actions required to run a reassembly job 
are exactly the same as those required for 
a new assembly. 


Interrupted Assemblies on Card Systems 


If a card system assembly job is inter- 
rupted after the completion of Phase 1, but 
before the conclusion of Phase 2, a special 
procedure is provided to complete the 
assembly job without re-executing Phase 1. 
Tape assembly jobs may not be interrupted. 


When this procedure is used, it is only 
necessary to run Phase 2 of the assembler 
(Phase 1 was run before the interruption). 
Input to Phase 2, in this case, is the same 
as that required for a new assembly, with 
one exception. That exception consists of 
placing the symbol table deck (produced by 
Phase 1 before the interruption) on top of 
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the Phase 2 assembler deck in the input 
card hopper. The rest of the Phase 2 input 
is then placed on top of the symbol table 
deck. Other than setting up the Phase 2 
input, the actions required to run Phase 2 
are the same as those required to run Phase 
2 of a new assembly. 


1442 Card Systems with Card Output 


Occasionally, when running an assembly 
job on a 1442 card system with card output, 
a program wait occurs during Phase 2 with 
the location counter containing 2HA, indi- 
cating the need for more blank cards. If 
the system has provisions for typing mes- 
sages, a message "2HA" is typed out. In 
either case, blank cards must be placed in 
the 1442 card hopper and the interrupt key 
must be pressed (see Figure 4). 


This intervention may be avoided by 
interleaving blank cards with the source 
program deck before starting Phase 2 of the 


assembler. The size of the system's stor- 
age governs the manner in which the blank 
cards are interleaved with the Source pro- 
gram, aS Shown in the following: 
Main-Storage 
Size Action 
8K Insert approximately 15 blank 
cards after each 150 source 
program cards. 
16K Insert approximately 80 blank 
cards after each 800 source 
program cards. 
32K Insert approximately 200 
blank cards after each 2,000 
source program cards. 
64K Insert approximately 800 


blank cards after each 


8,000 
source program cards. 


The Single-phase dump program is 
designed to produce listings of the con- 
tents of registers and/or storage. 


When used, the single-phase dump program 
resides in storage along with the user's 
program. Figure 7 shows the relationship 
between the single-phase dump program and 
the user's program. 


INITIALIZATION OF THE SINGLE-PHASE DUMP 
PROGRAM 


The single-phase dump program is avail- 
able from IBM in symbolic form on _ punched 
cards (that is, a source deck) and as an 
assembled relocatable object deck. Before 
the program can be used, it will require 
modification for operation on the 
installation's machine. This modification 
consists of altering three constants near 
the end of the IBM-supplied program. These 
constants are shown in Figure 8. They are 
identified in the figure by the number 1 in 
column one on the left-hand side. One must 
ensure that these locations properly 
describe the installation's machine con- 
figuration before using the single-phase 
dump program. Note that a card's position 
in the deck should not be altered during 
the modification process. 


USING THE SINGLE-PHASE DUMP PROGRAM 


The single-phase dump program is essen- 
tially a subprogram designed for use by the 


storage areas to be listed| 
and passes control to the | 


™ 
| 

| 

ee 

| Defines registers and/or |<----> 
| 

ee 

| Single-phase dump program 

| 
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Figure 7. The Single-Phase Dump Program 
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programmer; its use, therefore, is primari- 
ly his concern. He must define, in his 
program, the registers and/or storage areas 
whose contents are to be listed. In addi- 
tion, he must define the format of the 
listing. Finally, he must transfer control 
to the single-phase dump program in order 
to have the listing produced. 


In order to execute a program that uses 
the single-phase dump program, both pro- 
grams must reside in storage, and the 
proper linkage must exist between them. 
These requirements can be fulfilled by 
either of two methods. 


One method consists of 
Single-phase dump and user's programs 
together. The resulting assembled object 
program contains both the single-phase dump 
and problem programs with the appropriate 
linkages. It can be loaded into storage 
for execution by the Absolute or Relocating 


assembling the 


Loaders. (The Relocating Loader cannot be 
used to accomplish this on an 8K configu- 
ration.) 


The other method consists of 
the single-phase 
separately. In this case, 
assembled object programs must be loaded 
into storage for execution by the Relocat- 
ing Loader. Note that during the load 
process, the dump program should precede 
the user's program into storage so that the 
loader can establish the proper linkages. 


assembling 
dump and user programs 
the respective 


ce a nn i i ee a te cr ee ee se cre ee ce te ere cee cae ee ee ST SS ee se 


. 
| 
| 
| 
| 
Produces listing of the | | 
contents of the registers |--> Listing | 
and/or storage areas | | 
defined by the user's | | 
program and returns | | 
control to the user | | 

| 

| 

J 
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1. Single-Phase Dump Program 


2. Phase 1 of the Two-Phase Dump Program 


3. Phase 2 of the Two-Phase Dump Program 


PF otc. e BS a a a aaa a al 1 
tt dl lOpera-| | a 

{1]2{3] Name | tion | Operand | Description | 
}—-+-}-4------}---~-- 4 ----------- | ------------- ~--------—-------=------------------------ 
{1,2] |DSTOPL] DC |AL3 (zzzzz) |zzzzz represents the machine's storage size in bytes. | 


| | {Valid operands may be: | 


| | | | 
| | AL3 (8192) AL3 (16384) AL3 (32768) AL3 (65536) | 


i | 
| | 
I | 
a a ea er OR ee WaT LRU GST Oger aS AT 
| 3|INDEV | DC |X*zzzzzzzz'|zzzzzzzz represents eight hexadecimal digits generated| 
{ | | | jin the following way: | 
| | | | | | 
i | | | [Digits Description | 
| | | | | 1-3 Always 0. | 
1 | | | | 4 Specifies the Phase 2 input device: | 
| | | | | 0 = IBM 2400 Series Magnetic Tape Unit | 
| | | | | 1 = IBM 2540 or 1442-2 Card Reader-Punch | 
1 | | | 5 Always 0. | 
1 4 | | | 6-8 The three-digit hexadecimal address of the| 
If | | | Phase 2 input device. 
~t-+--—-- $---——- }---------—- [oan nnn { 
| 3} OUTDEV| DC |X‘ zzzzzzzz'|zzzzzzzz represents eight hexadecimal digits generated| 
1 | | | jin the following way: 
1 | | | | 
| | | | [Digits Description | 
{ | | | | 13 Always 0. | 
1 | | | | 4 For the Single-Phase Dump Program and Phase 2| 
{i | | | | of the Two-Phase Dump Program, this digit| 
| | | | | specifies the type of output device used to| 
| | | | | produce listings. | 
} | | | | 0 = IBM 1403 or 1443-2 Printer | 
i | | | | 1 = IBM 1052 Printer-Keyboard 
| | | | For Phase 1 of the Two-Phase Dump Program, this| 
| | | | | digit specifies the type of output device used| 
1 | | | | by Phase 1. | 
i | | | | 0 = IBM 2400 Series Magnetic Tape Unit | 
i | | | | 1 = IBM 2540 Card Reader-Punch | 
i | | | | 2 = IBM 1442-2 Card Reader-Punch | 
| | | | | 5 Always 0. | 
i | | | | 6-8 The three-digit hexadecimal address of the| 
i | | | { output device. | 
~+~4------ t------ $----------- {--~~---—---—---—~-- ~~ = - 2-2 : 
| 3] TYPWTR| DC |[X"zzzz* |zzzz represents a 0 followed by the three-digit hexa-| 
{ | | | jdecimal address of the printer or printer-keyboard used| 
{ | | | jto produce operator messages. If neither device is| 
1 | | | Javailable, the operand must be specified as X'FFFF'.| 
| | | | {Placing hexadecimal F's in TWPWTR only informs the dump] 
1 | | | {program that no IBM 1052 Printer-Keyboard is available| 
i | | | Jand does not disable the Input/Output Routine from| 
1 | | | jtrying to print error messages. There are two ways to| 
1 | | | |disable printing by the I/O routines. | 
i | | | | | 
1 | | | | 1. Prior to assembly time, remove the Write Error] 
1 | | | | Message Base Routine module from the I/O routines. | 
1 | | | | 2. At object time, insert a Replace card. to put the| 
1 | | | | LPSW instruction at SAGINW+4 (in the I/O Base| 
{ | | | | Routine - Group 1, Interrogate I/0 Interrupt or| 
in | | | | Condition Code 1 module) back in the same form as| 
1 | | | | on the assembly listing after it has been overlaid| 
1 | | | | by the branch instruction in the Write Error| 
| | | | | Message Base Routine module. | 
BI a eyesore he es cola i as Re as i ag 


Figure 8. Dump Program Initialization Cards 
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The Two-Phase Dump Program produces 
listings of the contents of registers 
and/or main storage. The program consists 
of two phases, Phase 1 and Phase 2. 


Phase 1 is designed to produce card 
image records (on punched cards or magnetic 
tape) of the contents of registers and/or 
storage. When used, it resides in storage 
along with the user's program. Figure 9 
shows the relationship between Phase 1 and 
the user"s program. 


INITIALIZATION OF THE TWO-PHASE DUMP 
PROGRAM 


The Two-Phase Dump Program is available 
from IBM in symbolic form on punched cards 
(that is, a source deck) for each phase as 
an assembled relocatable object deck for 
Phase 1 and as an assembled nonrelocatable 
deck (seif-loading deck) for Phase 2 
Before the program can be used, each phase 
may require modification for operation on 
the installation's machine. This modifica- 
tion consists of altering three constants 
near the end of each phase in the IBM- 
supplied programs or punching information 
in the END card in the case of Phase 2 
assembled nonrelocatable deck. 


The constants in question are shown in 
Figure 8. Constants to be modified in the 
Phase 1 program are identified by the 


number 2 in column two on the left-hand 
Side of the figure. Constants to be 
modified in the Phase 2 program are iden- 
tified by the number 3 in column three. 
One must ensure that these constants pro- 
perly describe the installation's machine 
configuration before assembling the Phase 1 


a a nn ce oe ea EE SE A SE SN SO AO A SARA Se 
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Figure 9. The Two-Phase Dump Program 
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jJand returns control 
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or Phase 2 source decks or by altering the 
assembled relocatable decks with Replace 
cards at object time or by punching infor- 
mation in the END card of the Phase 2 
self-loading deck. Note that a card's 
position in the source deck should not be 
altered during the modification process. 


USING THE TWO-PHASE DUMP PROGRAM 


Each phase of the Two-Phase Dump Program 
has its own set of operating procedures. 
These procedures are described in the fol- 
lowing text. 


Phase 1 

Phase 1 is used in essentially the same 
way as the Single-Phase Dump Program (see 
the topic "Using the Single-Phase Dump 


Program") . The two differ only with 
respect to their output. Phase 1 produces 
card or tape output for subsequent use by 
Phase 2. The Single-Phase Dump Program 
produces listings. Note that if tape is 
Jused for output, this tape is only rewound 
at end-of-reel by Phase 1. This enables 
the user to place the dump output of more 
than one program on a Single reel for later 
processing by Phase 2. 


Phase 2 


Phase 2 produces listings of the con- 
tents of registers and/or storage from the 
output generated by Phase 1. 


ce A A ae A SN A A A I SN NS a <a eS eS MS 


Phase 1 
output 


4 
| 
| 
| 
| 

{Produces a_ | | 

J listing from| | 

|-> Listing | 

{generated by] | 

{Phase 1 | 

| 
| 
| 
| 
Jj 


or tape 
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Phase 2, as supplied by IBM, is a 
self-loading version. To use the self- 


loading deck, the following must be 
supplied: 
1. The type of output device and its 
address. 
2. The type of input device and its 
address. 
3. The address of the IBM 1052 Printer- 
Keyboard (if one is available for 


operator messages) . 


The user supplies this information by 
taking out the END card from the self- 
loading deck of Phase 2 of the two-phase 
dump and punching this card as follows: 


wires SR Re a a a LY | 
|Cols. | Description | 
[---~-}-~---------~------~---------------- { 
}17-20|] The address of the output device | 
| | -- a printer or an IBM 1052 | 
| | Printer-Keyboard. | 
| | | 
|21 | 0 if a printer is to be used. | 
| { 1 if an IBM 1052 Printer-Keyboard | 
| | is to be used, | 
| | | 
]}22-25| Address of the input device to be | 
| | used. { 
| |, , ee | 
| 26 | 0 if the input device is a tape | 
| {| unit. | 
| | 1 aif the input device is a card | 
| | reader. | 
| | | 
|27-30| The address of the IBM 1052 | 
| | Printer-Keyboard if one is avail- | 
| | able. | 
j | FFFF if no IBM 1052 Printer- | 
| | Keyboard is available. | 
een a ta ce Na te J 


I/O error messages are only displayed on 
the console during error waits when the 
self-loading deck supplied by IBM is’ used. 


To use Phase 2 of the Two-Phase Dump 
Program in its self-loading version, the 
following steps must be performed: 


1. Run cards out of the card reader. 
2. Place the properly initialized self- 


loading deck of Phase 2 in the card- 
read hopper. 


3. Place the Phase 1 output on the 
appropriate unit. This unit address 
was defined to Phase 2 in the _ END 


card. If tape is used, the tape will 
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be rewound at the beginning of execu- 
tion. If card reader was used for 
Phase 1 output, this output should be 
followed by at least one blank card to 
ensure that the last listing will 
print. 


4. Set the load unit switches on the 
system control panel to address the 
card reader and press the load key. 


A user with a machine larger than 8K can 
make more efficient use of Phase 2 of the 
two-phase dump by altering the source pro- 
gram for residence in higher storage and 
increasing the buffer size. The assembled 
deck can then be loaded by . either the 
absolute or relocating loader. In order to 


use Phase 2 in this form (an assembled 
relocatable version), the following are 
required: 


1. A properly prepared and assembled 


Phase 2 program. 


2. The output generated by Phase 1. The 
output can be on cards or tape. 


3. A self-loading loader on cards. 


Phase 2 in its assembled 
version, perform the following 


To execute 
relocatable 
steps: 


1. Run cards out of the card reader. 


2. Prepare the self-loading Absolute or 
Relocating Loader to read from the 
device containing Phase 2 of the .two- 
phase dump program. The method of 
initialization is described in the 
section "The Absolute and Relocating 
Loaders." 

3. Place the self-loading loader in the 

card read hopper. 


4. Place Phase 2 of the two-phase dump 
program on the appropriate device. 


5. Place the Phase 1 
appropriate unit. This unit address 
was defined to Phase 2 during the 
Phase 2 initialization process (see 
the topic “Initializing the Two-Phase 
Dump Program") . If tape, the tape 


output on the 


will be rewound at the beginning of 
Phase 2. If card, Phase 1 output 
should be followed by at least one 
blank card to ensure that the last 
listing will print. 

6. Set the load-unit switches on the 


system control panel to address the 
card reader, and press the load key. 


The self-loading dump program is essen- 
tially the single-phase dump program in 
self-loading form. It produces listings of 
all of storage (excluding the area in lower 
storage occupied by the dump program -- 
approximately 3,000 bytes) and the contents 
of all general registers. However, the 
loading process destroys the original con- 
tents of 11 general registers but leaves 
registers 0, 7, 9, 10, and 15 intact. The 
listings are produced in full-word hexa- 
decimal format. 


Since the program is self-loading, it 
can be loaded and executed at any time. 
Its primary purpose is to provide a means 
of obtaining a dump when a program comes to 
an abnormal end. 


USING THE SELF-LOADING DUMP PROGRAM 


In order to use the self-loading dump 
program, perform the following steps: 


1. Run cards out of the card reader. 


2. Place the properly initialized self- 
loading dump program deck in the card 
read hopper. (Initialization of the 
self-loading dump program is described 
below.) 


3. Initialize the load-unit switches on 
the system control panel to address 
the card reader and press the load 
key. 


INITIALIZING THE SELF-LOADING DUMP PROGRAM 


The self-loading dump program is 
supplied by IBM in  self-loading form on 
punched cards (that is, an object deck in 
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self-loading form). Before the program can 
be used, it must be initialized to operate 
on the installation's machine. This ini- 
tialization consists of modifying the END 
card (that is, the last card) in the 
IBM-supplied deck. 


The END card initialization is described 
below: 


Ge a ee ag a 1 
[Cols. | Description | 
~---- 4--—-------~-~~---------~-----------| 
{T7201 0 followed by the three-digit | 
| | hexadecimal address of the unit | 
| {| used to produce the listing. | 
| | | 
,21 {} 0 if the listings are to be | 
| | produced on a printer. | 
| | 1 aif the listings are to be | 
| | produced on a 1052 Printer- | 
| | Keyboard. | 
| | | 
{22-26| The storage size of the | 
| {| installation's machine in | 
| | hexadecimai code. Valid sizes | 
| | are: | 
| | | 
| | Hexadecimal | 
| | Decimal Value Equivalent | 
| | | 
| | 08192 02000 | 
| | 16384 04000 | 
| | 32768 08000 | 
| j 65536 10000 | 
| | | 
}|27-30| 0 followed by the three-digit | 
| | hexadecimal address of the | 
| | machine's printer-keyboard (used | 
| | for the end-of-7job message) . | 
| | FFFF if a printer-keyboard is not | 
| {| available. | 
eee ap s ae ia oh Aee  e ha f J 
Note: I/O Support Package error indica- 
tions will not be typed but will appear in 
the PSW. (See Appendix A.) 


The Self-Loading Dump Program 17 


THE ABSOLUTE AND RELOCATING LOADERS 


Two load programs are available from 
IBM: the Absolute Loader and the Relocating 
Loader. Both are designed to load assem- 
bled programs (from cards or tape) into 
storage for execution. They are available 
in two versions: one is assembled to occupy 
lower storage and the other to occupy 
higher storage on an 8K configuration. 
Certain installations may want loaders that 


reside elsewhere in storage and/or disable 
the printing of I/0 error messages. For 
these reasons, both loaders are available 


from IBM in symbolic form on punched cards. 
See the description of the Loader Generator 
program for information on generating self- 
loading loaders. (Use of the Relocating 
Loader is recommended for users with 
greater than 8K main storage.) 


PREPARING THE LOADERS FOR USE 


The Absolute and Relocating Loaders are 
available from IBM in self-loading form on 
punched cards. Before either program can 
be used, it may require modification for 
operation on the installation's machine. 
This modification consists of altering the 
program's END card. 


last card in the 
It must include the following: 


The END card is the 
deck. 


{Cols.| Description 

iezel Blank if the program to be loaded 
is on the same device as the 
loader. 

0 followed by the 
hexadecimal address 
from which the program is 
loaded if it is ona different 


1 
| 

4 

| 

| 

| 

three-digit | 
| 

| 

| 

unit from the loader. | 
| 

| 

| 

| 

| 

| 

| 

| 

| 

a] 


of the unit 
to be 


0 followed by the three-digit 
address of the 
installation's printer or 
printer-keyboard (used to produce 
operator messages). 

Blank if neither device is avail- 
able. 


hexadecimal 
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LOADER OPTIONS AND MODIFICATIONS 


The loader source programs available 
from IBM are designed for residence in 
lower storage, beginning at location 128. 
The programs can be broken into the follow- 
ing general groups: 


Introduction 

I/O Routines 

Loader Routines 

Initial Entry Routine (IER) 


They are organized as such so that the user 
can overlay the Initial Entry Routine with 
the beginning or end of his program, if he 


wishes. After loading, he can overlay the 
loader routines during execution and still 
use the loader’s I/O routines if he is 


exercising that option. 


If the loaders are to be modified for 


residence in higher storage, it is recom- 
mended that the groups be reorganized to 
Make optimum use of available storage, as 


described below. 


To modify the Absolute Loader for resi- 
dence in upper storage, the following 
alterations to the source deck are neces- 
sary: 


1. Remove the constant IOTA EQU * from 
the end of the deck. Insert the 
constant IOTA EQU #-160 in the begin- 
ning of the deck, in place of the 
comment card *IOTA EQU *-160. 


2. Move the Initial Entry Routine from 
the end of the deck to the position 
specified by the comments following 


the new constant IOTA. 


3. Move the Loader Routines (Hex-Bin Con- 
version Routine through the end of 
Constants Area) to precede the I/0 
Routines. The constants THE END and 
OMEGA should now precede the END card. 


4. Alter the START card to the desired 
Starting address of the new loader. 


5. Assemble the modified deck and gener- 
ate a self-loading deck using the 
LDRGEN program. 


To modify the Relocating Loader 
residence in upper storage, the 
alterations 
sary: 


for 
following 
to the source deck are neces- 


1. Remove the constant IOTA EQU * from 
the end of the deck. Insert the 
constant IOTA EQU *-160 in the begin- 


ning of the deck, in place of the 
comment card *IOTA EQU *-160. 


2. Move the Initial Entry Routine from 
the end of the deck to the position 
specified by the comments following 
the new constant IOTA. 


3. Move the Loader Routine (Hex-Bin Con- 
version Routine through end of Con- 


stants Area) to precede the I/O Rou- 
tines. The constant OMEGA should 
still precede the END. card. 

4. Change the existing constants TOP, 


BELOW, and CTRSET to the followings: 


TOP EQU MON 
BELOW DC A (LOAD2) 
CTRSET Dc XL4'80" 


5. Alter the START card to the desired 
starting address of the new loader. 


6. Assemble the modified deck and gener- 
ate a self-loading deck using the 
LDRGEN program. 


LOADING CAPACITY 


The Relocating Loader available from IBM 
is set for a maximum storage size of 8K. 
To modify the Relocating Loader designed 
for residence in lower storage for a larger 
storage Size than 8K, it iS necessary to 
alter the constant TOP; this constant may 


be altered as described in the listing (the 
description of this alteration occurs just 
before the actual constant), or it may be 
altered to 131071 for 128K storage. The 
source deck should then be assembled and a 
new loader generated using the LDRGEN pro- 
gram. 


USING THE LOADERS 


To load an assembled program into stor- 
age for execution, the following two items 
are required: 


1. An Absolute or Relocating Loader in 
self-loading form on punched cards. 


2. The assembled program to be loaded. 
The program may exist on punched cards 
or magnetic tape. 


To run a 
steps: 


job, perform the following 


1. Run cards out of the card reader. 


2. Place the Absolute or Relocating Load- 
er in the reader hopper. The loader 
must be initialized as described under 
"Preparing the Loaders for Use." 


3. Place the assembled program on the 
input unit from which it is to be 
loaded. ; 


4. Set the load-unit switches on the 


system control panel to address’ the 
card reader, and press the ioad key. 
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LOADER GENERATOR PROGRAM 


The self-loading Absolute and Relocating 
Loaders available from IBM reside in lower 
storage during execution (higher storage in 
an 8K configuration). They are not in a 
form suitable for relocation. Since 
installations may want self-~loading loaders 
that reside elsewhere in storage, IBM sup- 
plies a means to create them. This 
involves the use of the IBM-supplied Loader 
Generator (LDRGEN) program. 


IBM provides both the Absolute and Relo- 
cating Loaders in symbolic form on punched 
cards. To create a self-loading loader, 
one must assemble the associated symbolic 
deck. The assembled loader is then loaded 
into storage with the LDRGEN program. 


The LDRGEN program is designed to regen- 
erate assembled loaders into a form suita- 
ble for direct loading into storage -- that 
is, to make them self-loading. Figure 10 
shows the sequence of operations required 
to produce a self-loading loader. 


PREPARING THE LDRGEN DECK FOR ASSEMBLY 


The LDRGEN program as supplied by IBM is 
in symbolic form on punched cards. Before 
the LDRGEN source deck can be assembled for 
use, the address of the card reader-punch 
upon which the self-loading loaders are to 
be written must be defined. This is accom- 
plished by inserting an Equate card in the 
LDRGEN source deck just before the END 
card. The format of the Equate card is: 


Ree ne te en 1 
| Name | Operation| Operand | 


JOUTPUT | EQU |A decimal or 
{mal self-defining value] 


| 
| Jequivalent to the ad-| 
| 


hexadeci- | 


| 
| 
| 
| 
L 


{dress of the output| 

| junit. | 
Rice atta Wt Se ee So See Se at) 
a a es 
| 
| Loader | Assembler | Assembled 
| Source -->{ Program |--> Loader 
| Program | | on Cards 
| eae ee corte Jd 
| 
Eras re a ne ee 
Figure 10. The LDRGEN Program 
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been inserted 
program can be 


Once the Equate card has 
in the deck, the LDRGEN 
assembled. 


RUNNING A JOB 


In order to produce a self-loading load- 
er, both the assembled loader (to be regen- 
erated in self-loading form) and the assem- 
bled LDRGEN program must be loaded into 
storage. Since neither is self-loading, a 
separate load program must be used. Neith- 
er of these programs can overlay the self- 
loading loader used to load them. Two such 
programs are available in self-loading 
form: the Absolute Loader and the 
Relocating Loader. The use of each is 
described in the following text. 


Using the Absolute Loader 


Since the Absolute Loader loads programs 
into the storage locations assigned to them 
by the assembier, care must be taken to 
ensure that none of the programs to be 
loaded overlays another. 


To use the Absolute Loader, one must 


have: 
self-loading 


1. The Absolute Loader in 


form. 
2. An assembled LDRGEN program. 


3. The assembled loader to be regenerated 
in self-loading form. Note that the 
storage locations at which the loader 
was assembled are the ones assigned to 
the self-loading loader produced by 
the LDRGEN program. 


cards. These cards 
in the LDRGEN program. 


4. Several Replace 
replace data 


See eee ee ee ee a ee es ee 7 
| 

~~--------- | 

| LDRGEN | Self-Loading { 

-->| Program |--> Loader | 

| | on Cards | 

ee oe ene en 4 | 

| 
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They define addresses in the assembled 
loader and, if applicable, specify the 
number of duplicate self-loading load- 
er decks to be produced by the LDRGEN 
program. The addresses in the assem- 
bled loader that they specify and the 
places in the LDRGEN program at which 
these addresses are inserted are shown 
in the following lists. 


Inserted at 


Symbolic Location 
in _LDRGEN Program 


Address of Symbol 
in Assembled Loader 


ALPHA ALPHAA 
ALPHA ALPHAB 
BETA BETAA 
IOTA IOTAA 
OMEGA OMEGAA 


If duplicate self-loading decks are 


desired, a Replace card is used to 
insert the number of duplicates 
desired ina half-word area in the 


LDRGEN program named CON. 


To run a job, the self-loading Absolute 
Loader is placed in the card read hopper. 
The assembled loader is placed behind it. 
The Replace cards are inserted in the 
assembled LDRGEN deck immediately after the 
Text cards, and the entire deck is placed 
behind the assembled loader in the card 
reader hopper. The card reader-punch upon 
which the self-loading loader is to be 
written is prepared for use. Then the 
load-unit switches on the system control 
panel are set to address the card reader, 
and the load key is pressed. 


Using the Relocating Loader 


Since the Relocating Loader loads pro- 
grams into storage at the locations speci- 
fied by Set Location Counter (SLC) cards, 
care must be taken when specifying these 


cards so as to ensure that the programs to 
be loaded do not overlay one another. SLC 
cards are described in the publication IBM 


System/360 Basic Programming Support Basic 
Utilities, Form C28-6505. 


To use the Relocating Loader, one must 
have: 


1. The Relocating Loader in self-loading 
form. 


2. An assembled LDRGEN program. 


3. The assembled loader to be regenerated 
in self-loading form. Note that the 
storage locations into which this pro- 
gram is loaded by the Relocating Load- 
er are the ones assigned to the self- 
loading loader produced by the LDRGEN 
program. 


4. A single Replace card, if duplicate 
self-loading decks are to be produced 
by the LDRGEN program. The Replace 
card inserts the number of duplicates 
in a half-word area in the LDRGEN 
program called CON. Note that the 
Replace cards that define addresses 
when the Absolute Loader is used are 
not required in this case. The 
Relocating Loader performs this func- 
tion automatically. 


To run a job, the self-loading Relocat- 
ing Loader is placed in the card read 


hopper. The assembled loader is placed 
behind it. If applicable, the Replace card 
(for duplicate decks) is inserted in the 


assembled LDRGEN deck immediately after the 


Text cards, and the entire deck is placed 
behind the assembled loader in the card 
read hopper. A Load Terminate card, with 


LDRGEN in columns 17-22, is then placed in 
the card read hopper. The card reader- 
punch upon which LDRGEN will write the 
self-loading program(s) iS prepared for 
use. The load-unit switches on the system 
control panel are set to address the card 
reader and the load key is pressed. 
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INPUT/OUTPUT SUPPORT PACKAGE 


IBM supplies a group of routines 
designed to provide the programmer with the 
coding required to use input/output devi- 
ces. This group of routines is called the 
Input/Output Support Package. 


The routines are available in symbolic 
and assembled form on punched cards. The 
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use of the IBM-supplied decks is exclusive- 
ly the task of the programmer and, there- 
fore, will not be described in this publi- 
cation. For detailed information on the 
Input/Output Support Package, refer to the 
publication IBM System/360 Basic Program- 


ming Support Basic Utilities, Form 
C28-6505. 


APPENDIX A: 


A program wait occurs whenever the Basic 
Assembler or Basic Utility programs find it 
necessary to communicate with the operator. 
A program wait is indicated by the wait 
light on the system control panel. 


When a program wait occurs, the three 
low-order bytes of the current PSW contain 
a three-character code, each character con- 
sisting of eight bits. This code identifi- 
es the reason for the program wait. This 
code can be displayed on the system control 
panel through use of the storage-select 
switch and the address’ switches. The 
storage-select switch is set to display the 
current PSW. The address switches are set 
to display the three low-order bytes in the 
PSW. Smaller System/360 models may display 
oniy the last byte or the last two bytes. 


The first character of the code iden- 
tifies the program being executed when the 
program wait occurred. The characters and 
the programs with which they are associated 
are shown in the following: 


cto Set Ge “7 
| Character | Program | 
| ------~---~-}--~------------------------- 
| A | Assembler (both phases) | 
| 1 {| Assembler (Phase 1 only) | 
| 2 | Assembler (Phase 2 only) | 
| D | Dump Programs | 
| G | Loader Generator | 
| I {| I/O Support Package | 
| L | Loaders | 
[Sy eee oe ees I tA Ste J 


The third character of the code can be 


one of the following: 


A Operator action is necessary. No 
decision on the part of the operator 
is required. 

\ 

D Operator action is necessary. The 
Operator must, however, make a deci- 
Sion on the course of action to be 
taken. 


Ss A program wait has occurred because 
of a machine error. The job cannot 
continue. SEREP interface has been 
set up, and the SEREP program should 
be loaded and executed. Save the 
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SEREP?t printout for Field Engineer- 
ing analysis. if attention is 
required, Field Engineering should 
be notified. Once SEREP has com- 
pleted its processing, the operator 
must re-initialize the system to 
rerun the error-interrupted job or 
to proceed with the next job. 


WwW A program wait has occurred because 
of a program check. The job cannot 
continue. 


I Operator information only 


If the installation has provisions to 


print operator messages, the three- 
character code iS printed on the output 
device. In some cases, the code is 
followed by a descriptive message. In 
others, it is followed by ae string of 
hexadecimal characters which define the 
conditions that exist as the result of an 


erroneous I/O operation. 


The following is a list (in alphabetical 
order) of all possible message codes. and 
their hexadecimal equivalents. It is pro- 
vided to enable easy translation of the 
display on the system control panel into 
the proper message code. 


Message Hexadecimal Message Hexadecimal 


Code Equivalent Code Equivalent 
AIA c1c9C1 I0OD C9OFOCH 
AID Cc1c9c4 Ios C9FOE2 
AIS C1C9E2 I1D COFITCH 
AMS C1D4E2 I1S C9OF1E2 
APW C1ID7E6 I3S C9OF3E2 
DEA C4cscl LAA D3C1C1 
DRA C4pD9C1 LDA D3C4HC1 
DTA C4E3C1 LED D3C5C4 
GCS C7C3E2 LKA D3D2C1 
GDD C7c4uC4 LOA D3D6C1 
GDS C7C4E2 LPA D3D7C1 
GEA C7C5cC1 LUA D3E4C1 
GIA C7C9C1 1EI F1C5C9 
GMS C7D4EE2 2EI F2C5C9 
GNS C7D5E2 2HA F2C8C1 
IMS CID4ER2 2SA F2E2C1 


1SEREP (System Environment Recording, Edit- 
ing, and Printing) provides Field Engineer- 
ing with detailed, accurate information 
about the system's environment at the time 
of a machine failure. 
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The program waits and messages presented 
in the following paragraphs are grouped 
according to the programs with which they 
are associated. Note that the I/O support 
package is built into each of the utility 
programs. Therefore, program waits listed 
under the I/O support package can occur 
during the execution of any of the utility 
programs. Where "Not typed" appears in 
parentheses after the three-character code, 
the code is displayed in the PSW but not 
typed on the output device. 


TWO-PHASE DUMP PROGRAM 


DEA END OF DUMP-PHASE 2 
Phase 2 of the two-phase dump program 
has been completed. 


Action: Proceed with the next job. 


DRA MT NEXT INPUT REEL 


Phase 2 of the two-phase dump program 
has encountered an end-of-reel condition 
on its input tape. The reel has been 
rewound and unloaded. 


Action: Mount next reel on the input 
unit and make the device ready. Then, 
press the interrupt key on the system 


control panel to proceed with the job. 


DTA MT NEW OUTPUT REEL 


Phase 1 of the two-phase dump program 
has encountered an end-of-reel condition 
on its output tape. The reel has been 
rewound and unloaded. 

Action: Mount a new work tape on the 
output unit. Then, press the interrupt 
key on the system control panel to 
proceed with the job. 


SELF- LOADING DUMP PROGRAM 


DEA END OF DUMP 


The self-loading dump program has been 


completed. 


Action: Proceed with the next job. 
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THE BASIC ASSEMBLER 


AIA (Not typed) 
The assembler has detected an I/O error 
which can be retried. 


Action: Continue the program by depress- 
ing the Interrupt key. If after five 
retries the error still exists, load and 
execute SEREP. 


AID (Not typed) 

The assembler is unable to. properly 
perform an I/O operation. The address 
of the associated I/O unit is contained 
in the low-order 11 bits of general 
register 2. 


Action: The action taken varies with the 
type of operation in error. 


e Tape Operation - Core location Ky 
hexadecimal (CSW unit status) should 
be interrogated. 


1. If the unit exception bit (bit 
7) is set, an end-of-file con- 
dition on input or an end-of- 


reel condition on output has 
occurred. The address of the 
device causing the unit 


exception will be located in 
the lower half of register 2. 
The operator should change that 
tape and press the interrupt 
key to continue the job. 


2. If the unit exception bit is not 
set, the operator should press 
the interrupt key to retry the 
operation. if after five 
retries the condition still 
exists, the operator should 
dump all of storage and discon- 
tinue the job. 


e Read - If a reader check light is on, 
the cards in the reader should be run 
out and reloaded. The operator 
should then press the interrupt key 
to retry the operation. If after one 
retry the condition still exists, the 
operator should mark the card in 
error and discontinue the job. 


e Punch (1442) - Rerun the job. 
e Punch (2540) - Mark bad card and 
press interrupt key to repeat the 


punch operation. 

e Write Line - Press interrupt key to 
repeat operation. 

e Space or Eject - Press interrupt key 
to repeat operation. 


AIS (Not typed) 
The assembler has detected an equipment 


failure while trying to execute an I/0 
operation. SEREP interface has been set 


up. 


Action: Load and execute SEREP. 


AMS (Not typed) 
A machine check has occurred. 


Action: Load and execute SEREP. 


APW (Not typed) 


occurred. The 
been altered in 


A program check has 
assembler program has 
some Way. 


Action: Dump all of storage and compare 
against listing to find the area 
altered. Correct if possible and rerun 
the job. 

1EI 
Phase 1 of the assembler has been com- 
pleted. 


Action: Proceed with Phase 2. 


2EI 


Phase 2 of the assembler has’ been 


pleted. 


com~ 


Action: Proceed with next job. 


2HA 


Phase 2 
blank cards be placed in the 
hopper. 


of the assembler requires that 
1442 card 


Action: Remove any cards in the 1442 
card hopper, insert blank cards, and 
replace the cards just removed. 


2SA 


Phase 2 of the assembler requires a 
blank card at the punch station or blank 
cards in the 1442 card hopper. 


Action: Remove cards from the hopper, 
run cards out of the 1442, and place 
them at the bottom of the cards just 
removed from the hopper. Place blank 
cards in the hopper and place the. cards 
removed from the 1442 on top of the 
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blanks. Make the unit ready and press 
the interrupt key on the system control 
panel to continue. 


THE ABSOLUTE AND RELOCATING LOADERS 


Several of the program waits associated 
with the load programs concern load control 
cards. References to these cards are made 
in abbreviated form in the descriptions 
that follow. The abbreviated titles and 
their equivalent names are given in the 
following list: 


ESD External Symbol Dictionary card 
Ics Include Segment card 
LDT Load Terminate card 
REP Replace card 
RLD Relocation List Dictionary card 
SLC Set Location Counter card 

Note: The preceding cards are described in 


the publication IBM System/360 Basic Pro- 


gramming Support Basic Utilities, Form 
C28-6505. 


LAA WAIT 


The relocating loader has encountered an 
invalid RLD or ESD card in the program 
being loaded. 


Action: Mark card and discontinue job. 


LDA WAIT 


The relocating loader has encountered 
duplicate entry points in the program 
being loaded. 


Action: Discontinue job. 


LED WAIT 


One of the following situations has 


occurred: 


1. The relocating loader has encoun- 
tered an end-of-file condition 
without having read an LDT card. 


2. The absolute loader has encountered 
an end-of-file condition without 
having read an END card. 


Action: Discontinue job if the program 
is being loaded from tape. If the 
program is being loaded from cards, make 
the reader not ready. A card with a 
12-2-9 punch in column one and the 
characters END or LDT (whichever is 
appropriate) in columns two through four 
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is then placed in the reader hopper. 
The device is made ready and the inter- 
rupt key on the system control panel is 
pressed. 


Note: The programmer should have includ- 
ed the proper LDT or END card in his 
source program. The operator action 
described in the preceding does not 
guarantee proper execution of the user's 
program. 


LKA (Not typed) 

The absolute or relocating loader has 
encountered an invalid SLC, ICS, or REP 
card in the program being loaded. This 
message is displayed but not typed for 
an invalid hexadecimal character. 


Action: Mark card and discontinue job. 


LOA WAIT 


An attempt has 
program 
reserved for use 
relocating loader. 


been made to loada 
into main storage locations 
by the absolute or 


Action: Discontinue job. 


LPA (Not typed) 


A program check has occurred. Note that 
this wait can occur during the execution 
of any program loaded into storage by 
either the Absolute or Relocating Pro- 
gram Loader. 


Action: Discontinue ‘job. 


LUA WAIT 


The relocating loader has encountered an 
undefined symbol in an SLC, ESD type 2, 
or LDT card in the program being loaded. 


Action: Mark card and discontinue job. 


INPUT/OUTPUT SUPPORT PACKAGE 


The Input/Output Support Package is used 
by the IBM-supplied utility programs and by 
the programmer. In the case of the utility 
programs, the I/O package is built in prior 
to their distribution. 


When the input/output support routines 
are unable to properly execute an I/0 
operation, a program wait occurs to notify 
the operator of the unusual condition, and 
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SEREP Interface is set up. An operator 
message accompanies the program wait if the 


installation has provisions for printing 
messages. 
The Input/Output Support Package has 


three levels of messages. They are: 
1. ccc 

2- CCC IOOPSW CSW 

3. CCC IOOPSW CSW SBYTES 


where: 


ccc 
is the three-character code which iden- 
tifies the reason for the message. 


IOOPSW 
is the contents of the old input/output 
program status word in hexadecimal nota- 
tion. The channel and unit number of 
the I/O device in error is contained in 
bits 21-31 of this word. 


CSW 
is the contents of the channel status 
word associated with the operation in 


error. It is in hexadecimal notation. 
SBYTES 
is the contents of the six sense bytes 


in hexadecimal notation. 


All three levels will only appear when 
the full complement of error message expan- 
sions is included. The Basic Utility Pro- 
grams, other than the BaSic I/0 Support 
Package, contain only the first level. 


IMS (Not typed) 
A machine check has occurred. 


Action: Load and execute SEREP. 


I0D IOOPSW CSW SBYTES 


The input/output support package is una- 
ble to properly perform an I/O opera- 
tion. 


Action: The action taken varies with the 
operation in error: 


e Tape - If unit is not ready, make 
ready and press console Interrupt to 
retry operation. If retry is unsuc- 
cessful, discontinue job. 


e Punch Card - If the punch is not 
ready or out of cards, make it ready 
and press console Interrupt to retry 
the punch operation. If retry is 
unsuccessful, discontinue job. 


e Read Card - If the reader is not 
ready or out of cards, make it ready 
and press console Interrupt to retry 
the read operation. If retry is 
unsuccessful, discontinue job. 


e Write a Line - Press interrupt key to 
repeat the operation. If retry is 
unsuccessful, discontinue job. 


e Skip or Space - Press interrupt key 
to repeat the operation. If retry is 
unsuccessful, discontinue job. 


IOS IOOPSW CSW SBYTES 

The input/output support package is una- 
ble to properly execute an operation. 
The standard retries have been attempted 
and the error persists. 


Action: Load and execute SEREP. 


I1D IOOPSW CSW SBYTES 
One of the following has occurred: 


1. A request to start an I/O operation 
has been rejected because of a 
programming error. In this case, 
the busy bit (bit 35) in the chan- 
nel status word is off. 


2. An overlapped I/0 operation has 
been completed unsuccessfully while 
an attempt was being made to. start 
a new operation. In this case, the 
busy bit in the channel status word 
is on. 


Action: If the busy bit in the channel 
Status word is off, press the interrupt 
key on the system control panel to 
repeat the request for an I/O operation. 
If the operation is again rejected, 
discontinue the job and call the custom- 
er engineer. If the busy bit in the 
channel status word iS on, rerun the 
job. 


I1S IOOPSW CSW SBYTES 


One of the following has occurred: 


1. A request to start an input/output 
operation has been rejected because 
of a machine error. 


2. An overlapped I/0 operation has 
been completed unsuccessfully while 
an attempt was being made to start 
a new operation. 


Action: Load and execute SEREP. 
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I3S IOOPSW CSW SBYTES 

The Input/Output Support Package 
attempted to use an I/O device which was 
not operational or not available. 


Action: Load and execute SEREP. 
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GCS (Not typed) 


A channel error has occurred. 


Action: Load and execute SEREP. 


GDD (Not typed) 
The LDRGEN program has attempted to 
punch a card but the operation resulted 
in an error. 


Action: Mark the 
card and press the 
repeat the operation. 


erroneously punched 
interrupt key to 


GDS (Not typed) 
A device failure has occurred. 


Action: Load and execute SEREP. 


GEA (Not typed) 


The LDRGEN program has been executed. 
This is a normal end-of-job situation. 


Action: Proceed with next job. 


GIA (Not typed) 


The punch unit has run out of blank 


cards. 
Action: Place blank cards in the punch 


hopper and press interrupt key to  con- 
tinue job. 


GMS (Not typed) 
Machine check has occurred. 


Action: Load and execute SEREP. 


GNS (Not typed) 


The device specified as the output unit 
in the LDRGEN program is not availabie. 


Action: Load and execute SEREP. 
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